Don't believe the hype
Take a look at the small print
Ignore the bold type
(Carter U.S.M, "Do Re Me, So Far So Good")

Hsc

(Version 0.916, 12-Jan-1998)

Es gibt keine deutschsprachige Dokumentation.

This is the documentation to hsc, a developer tool for html-projects. It acts as a preprocessor and supports macros, expressions, conditionals, include files, replaces special characters, performs a structure check, tests existence of local links and several other things. Optionally it can keep track of documents being processed and maintain the dependencies between them, making it relatively easy to integrate it into existing developer environments.

A current version of this program and manual should always be available from http://www.giga.or.at/~agi/hsc/, both as hypertext (html) and printabel (Postscript) document.

About The Program

• Introduction - What's this all about?
• Copyright And Disclaimer - not-my-fault, Freeware, source included
• Author - how to contact me
• Changes And News - what's new with this release
• Updates - where to find them

Before You Begin

• Requirements - what to own and know
• Archive Contents - things coming along
• Installation - where to put the whole damn thing

Usage

• Invoking hsc
  • Options and Switches - there are loads of them
  • Exit Code - return to sender
• Example Usage - how it is supposed to work
• File Arguments - specifying input and output
• Messages - shit happens
  • Message Elements
  • Message Classes
  • Message Options
  • List Of Messages
• Environment Variables - save the nature

Features

• Special Tags - make life a bit easier
• Check Existence of local URIs to avoid dangling links
• Project Relative URIs - avoid paths like "../../../image/back.gif"
• Replace Special Characters by their entities
• Get Size of images and set attributes WIDTH and HEIGHT
• Special Attributes - access various information
• Strip Specific Elements - comments, redundant linefeeds and white-spaces, unneeded tags, tags with external references
• Structure And Syntax Check to avoid surprises with different browsers

Advanced Topics

• Attribute Assignments
• Expressions - there's more to life than strings
  • Operators
  • Boolean Expressions
  • Priorities
• Macros - create your own shortcuts and templates.
  • Macro Modifiers
  • Attribute Declaration
  • Attribute Types
  • Attribute Modifiers
• Conditionals - what if..?
  • General Syntax
  • Some Simple Examples
  • Nesting Conditionals
  • Conditionals And Macros
• Syntax Definition - what to do if html version 17.3 is out
• Execute Shell Commands - poor man's pseudo-CGI
• Project Management - I'll make ya
  • Project Files - where hsc stores information about a project
  • hscpitt - hsc project interfering and trashing tool
  • make - a general purpose tool for project management
  • Makefiles - how to adopt them for hsc
  • hscdepp - hsc dependency procreator
  • hscpaltrow - a Rexx-script utilizing hscpitt
• Some Use-Cases - hints how to do certain things

Miscellaneous

• Questions - and maybe some answers..
• Source Code - compiling it
• Existing Ports - Amiga rulez? Not really.
• Other html-Extensions - pre²protranscessingpost
• Known Bugs, Problems and Limitations - don't whizz on the electric fence
• Future Improvements - what might happen
• Related stuff - tools and further information